home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / os2 / mony_121.zip / README < prev   
Text File  |  1996-05-28  |  9KB  |  237 lines

  1. MONY README
  2.  
  3. The file includes a history of changes, followed by a brief description of Mony.
  4.  
  5.  
  6. -----------
  7. 28-May-1996
  8. 1.21
  9.  
  10. MonySetPage no longer runs with interrupts disabled.
  11.  
  12. Added video refresh disable support (INT10,ah=12h,al=0|1,bl=36h).  If you need
  13. this and are using the mony_api module, add this routine or something similar:
  14.  
  15. // 12/bl=36 ----------
  16. // Set refresh disable
  17. //
  18. // Select either disable (al=1) or enable (al=0) [Mony does -not- return al=12h]
  19.  
  20. ULONG MonyDisableRefresh (HFILE monyID, UCHAR disable) {
  21.  
  22.    ULONG rc=0;
  23.    ULONG parmLen = sizeof(REGPACK);
  24.    REGPACK iREG;
  25.  
  26.    iREG.ah = 0x12;
  27.    iREG.al = disable;
  28.    iREG.bl = 0x36;
  29.  
  30.    rc = DosDevIOCtl(monyID,IOCTL_MONY,IOCTL_40TH,
  31.                     &iREG,sizeof(REGPACK),&parmLen,
  32.                     NULL,0,NULL);
  33.    return rc;
  34. }
  35.  
  36.  
  37. MONYPAGE.EXE:
  38.  
  39. Added MonyPage for simple page switching.  For each video page installed at
  40. DEVICE=MONY.SYS -p?, a button is enabled by which you can activate that page.
  41. This way you can switch to any Mony-program page from one spot, easily.  The
  42. +/- button at the end is to disable video refresh (turns off/on the scan beam).
  43. Switch options for MonyPage are:
  44.  
  45.  -noAbout       bypass version info message box
  46.  -cls           clear all video pages at start
  47.  -min           start minimized
  48.  -test          fills buffer of pages after page0 with the page number
  49.  
  50.  
  51. Doc update:
  52.  
  53. Set bit7=1 of video mode set (ah=0) to leave video memory as-is (mode=0x87),
  54. or set al=255 for a fast video mode set (not recommended for initial sets).
  55.  
  56.  
  57. -----------
  58. 21-Mar-1996
  59. 1.20
  60.  
  61. Extended evaluation period to double previous time (around 25 minutes).
  62. Reduced filesize to under 4KB (25% less filling) by removing the useless
  63. resource manager calls, and by streamlining data and code.  The monydemo.exe
  64. is slightly changed (monydemo.c).
  65.  
  66. Included are alternate mony_api.c and .h files for compilers that cannot handle
  67. unnamed unions (REGPACK).  The alternates are specifically for the emx/gcc
  68. compilers, but they'll probably work with others, too.  Contributions for other
  69. compilers (Ada, etc.) are desired, but there must be no strings attached if
  70. you want it included.
  71.  
  72. The license agreement has my definition of "Corporate Use" included.
  73.  
  74.  
  75. -----------
  76. 17-Feb-1996
  77. 1.10
  78.  
  79. No exported changes.
  80.  
  81.  
  82. -----------
  83. 01-Feb-1996
  84. 1.01
  85.  
  86. MONY$ reports as version 1.001.
  87.  
  88. WriteString and TTY output had been scrolling at row24/column80 rather
  89. than at row25/column80.
  90.  
  91. Changed mony_api.h as indicated in that file.
  92.  
  93.  
  94. -----------
  95. 25-Jan-1996
  96. 1.000
  97.  
  98. Topics covered include a description, requirements, installation
  99. instructions, and availability.  Additional coverage on use is in the
  100. monydemo.c, mony_api.c, and mony_api.h files.
  101.  
  102.  
  103. Description
  104. -----------
  105. MONY.SYS is an MDA device driver for OS/2.  MDA, or monochrome display
  106. adapater, also known as the Herc card, MGP, or just plain mono card, can
  107. be used together with a color VGA, and both can run at the same time.
  108. They can, that is, with proper support.  You can't get this with a base
  109. OS/2 install, so Mony was born (TJ's Mony).
  110.  
  111. Mony is designed for the OS/2 programmer, both application level programmer
  112. and device driver programmer.  The MDA BIOS (INT10 functions) are supported
  113. by the Mony emulator, with a few extensions added for ease of use.  For
  114. example, WriteString is supported, as is ReadBlock and WriteBlock.  Also,
  115. up to 8 video pages can be used, and switched to and from instantly.  This,
  116. of course, is not calling the ROM BIOS, but is emulating those functions in
  117. code.
  118.  
  119. Documentation is sourced in any INT10 BIOS specification.  Only the MDA
  120. BIOS is specifically supported, though several enhancements are provided.
  121. Check out the mony_api.c file for most of the supported routines.  Use
  122. a INT10 reference for detailed specs.
  123.  
  124. The programming interface is DosDevIOCtl calls, but an easy-to-use API
  125. (source included) is provided that simplifies use of all the functions.
  126. For example, WriteString is as simple as:
  127.  
  128.  ULONG MonyWriteString (HFILE monyID, PSZ strgPtr,
  129.                        UCHAR page, UCHAR attr, UCHAR row, UCHAR col);
  130.  
  131. A demonstration program is included which covers just about all the calls
  132. available for the application programmer.  For device driver programmers,
  133. a brief tutorial on how to access Mony from physical device drivers is
  134. located at the start of the mony_api.c file.  Everything you need to
  135. evaluate Mony is included.  Continued use beyond a short evaluation time
  136. requires payment of less than $15.00 for the individual in a non-corporate
  137. environment.  Corporate (site) licenses are $299.50.  Ordering instructions
  138. are included in the !ORDER.FRM file, or simply send your vitals and payment
  139. to:  Cornel Huth/6402 Ingram Rd/San Antonio, TX 78238/USA.  Refer to the
  140. license agreement in the !order.frm file before using Mony.
  141.  
  142.  
  143. Requirements
  144. ------------
  145.  
  146.  - OS/2 Warp 3.0 or later (may work on earlier 2.x versions)
  147.  - Monochrome display adapter or compatible (MDA, MGP, Herc, etc.)
  148.  - Digital/TTL monochrome display monitor
  149.  
  150. The mono video subsystem must be the non-primary display system.  In
  151. other words, you are expected to have a VGA or similar video system
  152. installed as the primary video subsystem.  It is not expected, nor
  153. desired, to use the OS/2 installation of a secondary display.  OS/2
  154. cannot make use of a secondary display concurrent with the primary
  155. display.  Mono VGA, or any VGA, cannot be used as a second monitor.
  156.  
  157. For performance reasons, a VLB or PCI primary video system is
  158. recommended.  Adding an 8-bit mono card has no effect whatsoever
  159. on the performance of the VLB/PCI video card.  However, adding an
  160. 8-bit card into the A0000-BFFFF region on an ISA (repeat ISA) bus
  161. causes all cards on that bus in that region to revert to 8-bit mode.
  162. So, if you don't have a VLB or PCI primary video card, you may not
  163. desire the performance loss of your ISA-based video card.  And again,
  164. if you do have VLB or PCI primary video, disregard this paragraph since
  165. it does not apply.
  166.  
  167. If you don't already have an MDA and mony (mono monitor), the going
  168. rate is about $15 for a new MDA card (often with a printer port, and
  169. often Herc compatible -- an MGP card, for mono, Herc-graphics,
  170. printer-port).  Mony displays are not that hard to find.  Any used-parts
  171. shop will have at least a few.  Going rate for a mony in good condition
  172. is about $30.  Avoid, if you can, any monitor with burn-in (where you can
  173. see stuff on the screen with the monitor off).  Total hardware cost is
  174. $45 or so, if you don't have it already, and total cost, with Mony, and
  175. everything, is under $60.
  176.  
  177. Mony registration may be closed at any time, so if you plan on registering
  178. "maybe later", be advised that Mony may no longer be available for sale at
  179. a later time (you will get your order returned, however).
  180.  
  181. In no case may Mony be used as part of a program/package that is distributed.
  182. The Mony license is for your use running on your single computer (or your
  183. computers at you site if site licensed).
  184.  
  185.  
  186. Installation
  187. ------------
  188.  
  189. MONY.SYS is an OS/2 device driver.  It is installed by adding the line
  190.  
  191.   DEVICE=MONY.SYS [-p#] [-q]
  192.  
  193. in the config.sys file (with appropriate path, if required).  Option
  194. switches are (use -, not /):
  195.  
  196.  -p#
  197.  
  198. where # is the video pages desired, from 1 to 8 (default=1).  To run the
  199. monydemo.exe program, it's recommended that you set up 8 video pages (-p8).
  200.  
  201.  
  202.  -q
  203.  
  204. can be used to quiet the MONY.SYS install banner, in case you like to
  205. look at the VGA OS/2 logo instead...  The banner on the mony monitor
  206. is always generated, and indicates that MONY.SYS installed correctly.
  207. If you don't see anything on the mony monitor by the time you have
  208. the desktop up and running, recheck your DEVICE= line and hardware/
  209. connections.
  210.  
  211.  
  212. Availability
  213. ------------
  214.  
  215. Current versions of MONY (filename mony_xxx.zip, where xxx is the
  216. version number, as in mony_121.zip) can be found at:
  217.  
  218. Internet FTP:  hobbes.nmsu.edu
  219.                /os2/drivers
  220.  
  221.          CIS:  OS2DF1
  222.                Device Drivers file area and elsewhere
  223.  
  224. Home sites:  See below.  These places -always- have the current releases.
  225.  
  226. Also check out AWACS.  It's a real-time swap file, system, com port, and
  227. caller-ID monitor, all rolled into one small program.  It shows things
  228. like swap file size, RAM total, free, idle, locked, resident, working set
  229. (also graphics), CPU pulse, time, com port and modem status, and caller
  230. ID info.  AWACS*.ZIP.
  231.  
  232. ...........................................................................
  233. Toolkits  [database] [sound] [utils]  |cornel@crl.com
  234.     DOS Bullet 1.25   DOS Ruckus 1.21 | ftp://ftp.crl.com/users/co/cornel
  235.   Win3x Bullet 1.26   W95 Bullet 2.05 |http://www.crl.com/~cornel/
  236.  DOSX32 Bullet 2.05  OS/2 Bullet 2.05 |BBS:(210)684-8065
  237.